NAME
	GU_LayoutMenusA -- Position all the menus and menu items.

   SYNOPSIS
	success = GU_LayoutMenusA(menu, vi, taglist)
	D0                        A0    A1  A2

	BOOL GU_LayoutMenusA(struct Menu *, APTR, struct TagItem *);

   FUNCTION
	Lays out all the menus, menu items and sub-items in the supplied
	menu according to the supplied visual information and tag parameters.
	This routine attempts to columnize and/or shift the MenuItems in
	the event that a menu would be too tall or too wide.

	These GadTools routines are only here to make it simpler for someone
	who wants to use them. This for example, is of no use if you use the
	GadUtil function GU_CreateLocMenuA() to define localized (optional)
	menus with automatic hotkey handlimg etc.

   INPUTS
	menu    - Pointer to menu obtained from GU_CreateMenusA() or
	          GU_CreateLocMenuA().
	vi      - Pointer returned by GU_GetVisualInfoA.
	taglist - Pointer to an array of tags providing optional extra
	          parameters.

   TAGS
	See gadtools/LayoutMenusA() for tags.

   RESULT
	success - TRUE if successfull, FALSE otherwise.

   NOTES
	See gadtools/LayoutMenusA() for more information.

   SEE ALSO
	GU_CreateMenusA(), GU_GetVisualInfoA(), gadtools/LayoutMenusA()

Converted on 19 Jul 1996 with RexxDoesAmigaGuide2HTML by Michael Ranner.